home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Misc / emu / fbzx.lha / fbzx / README < prev    next >
Text File  |  2004-01-06  |  8KB  |  193 lines
  1. FBZX
  2. A ZX Spectrum emulator for FrameBuffer
  3.  
  4.  
  5. DISCLAIMER
  6.  
  7. FBZX is distributed under the GPL license, version two or later, which means
  8. that is distributed "as is", without warraty of any kind. To know more details,
  9. read the file COPYING.
  10.  
  11. This doesn't apply completely to the Z80 core, which is copyrighted by
  12. Marat Fayzullin. For details about distribution of this part, please, visit
  13. Marat's homepage (http://fms.komkon.org/EMUL8). The terms for the Z80 code
  14. (copied and pasted from Marat's homepage) are:
  15.  
  16.     * You can use this software for any non-profit purposes, as long as you
  17.     make a proper reference to me (Marat) in the documentation, or the program
  18.     itself.
  19.     * You can't use any of this software to gain profit. This includes selling
  20.     it, using it for commercial projects, putting it onto CDROMs, etc. If you
  21.     want to use my (Marat's) code for a commercial project, please, contact
  22.     me (Marat) to negotiate the terms.
  23.     * You can't distribute this software yourself, by putting it onto your own
  24.     WWW or FTP sites, even if they are non-profit. It is ok to have it as a
  25.     part of another project though, such as an emulator or utility program.
  26.     * If you use any of my (Marat's) code for your own project, please, let me
  27.     (Marat) know about it: it is always nice to know that your work is needed. 
  28.  
  29.  
  30. WHAT IS FBZX?
  31.  
  32. FBZX is a Sinclair ZX Spectrum emulator, designed to work in FrameBuffer under
  33. Linux. It uses the SDL library, so it should be easily ported to other
  34. architectures. Please, read the file PORTS to know more details about this.
  35.  
  36. FBZX is based in the great Z80 emulator created by Marat Fayzullin
  37. (http://fms.komkon.org), but with some little modifications. Is possible that
  38. theses modifications will be added in new versions of this emulator, but to
  39. avoid problems, I strongly recomend to use only the files supplied in FBZX.
  40.  
  41. To work with FBZX you need:
  42.  
  43.     -A FrameBuffer-capable graphic card (or compatible with X-windows)
  44.     -A Linux system with FrameBuffer configured (can use X too)
  45.     -Sound Card (optional)
  46.  
  47. In order to get the maximum performance, your FrameBuffer driver must allow to
  48. change to 640x480 resolution in 8 bits. Only the VESAFB driver can have
  49. problems with this fact, so if you use this driver, be sure to boot your Linux
  50. box in 640x480 in 8 bits. If you don't do this, SDL will emulate that mode,
  51. resulting in a high performance penalty. Another solution iis to use the
  52. SuperVESAfb driver (see the FAQ). If you use an specific Framebuffer driver,
  53. (or SuperVESAfb) just don't worry: FBZX will automagically change the graphic
  54. mode when starts.
  55.  
  56.  
  57. WHAT CAPABILITIES HAVE FBZX?
  58.  
  59. FBZX can emulate the original 48K spectrum (issue 2 and issue 3), the original
  60. 128K, the Amstrad +2 and the Amstrad +2A.
  61.  
  62. The screen and the sound are emulated in a very acuracy way, so nearly all
  63. the sound and screen effects should work in this emulator.
  64.  
  65. 128K sound is emulated too, and can be disabled in 128K mode in order to save
  66. CPU time procesing, if your computer is slow.
  67.  
  68. It emulates the Interface I and one microdrive unit, allowing to load from and
  69. save to MDR files.
  70.  
  71. FBZX can handle Z80 snapshots (both load and save). In a future, more snapshot
  72. formats will be supported.
  73.  
  74. FBZX can handle TAP files (load and save), and have a fast-load mode that allows
  75. to load in milliseconds a TAP file. This fast-load mode is enabled by default, but
  76. can be disabled.
  77.  
  78. FBZX can also handle TZX files (see README.TZX for details).
  79.  
  80. FBZX can emulate the Kempston, Cursor, Sinclair 1 and Sinclair 2 joysticks,
  81. with the cursor keys. Fire is emulated with the right ALT key, ALT-GR key,
  82. WINDOWS MENU key or WINDOWS SYSTEM right key.
  83.  
  84.  
  85. HOW DO I USE FBZX?
  86.  
  87. To run FBZX just type
  88.  
  89.     fbzx
  90.  
  91. from a console.
  92.  
  93. You can run it without sound too, just typing:
  94.  
  95.     fbzx nosound
  96.     
  97. You can use this if you don't have a sound card, or it hasn't OSS support.
  98.  
  99. FBZX should work in X too, but it would run slower due to the penalty of the X
  100. Window System. So preferently run always FBZX from a console (unless you have
  101. a decent PC, of course. My AMD Duron 1'3GHz needs a very little more speed
  102. to make FBZX work fine in Xwindows, but in FrameBuffer works fine).
  103.  
  104. The PC keyboard works exactly like the Spectrum keyboard (but only numbers and
  105. letters). ENTER key is Return, CAPS SHIFT is in both Shift keys, and SYMBOL
  106. SHIFT is in both Control keys. I hope to add 'extended keys' in a near future.
  107.  
  108. Whit ESC you exit FBZX.
  109.  
  110. F1 shows a help page with all the available keys.
  111.  
  112. F2 sends you to a menu where you can load and save snapshots.
  113.  
  114. F3 sends you to a menu where you can choose a TAP/TZX file, rewind it,
  115. choose if you want normal speed or fast speed for loading, enable or
  116. disable the write protection, and create a new (and empty) TAP file.
  117.  
  118. F4 send you to a menu where you can choose the emulation type you want (48K,
  119. 128K, +2 or +2A), the joystick, enable or disable the AY emulation and enable
  120. or disable the Interface I.
  121.  
  122. F5 stops the tape when normal speed is selected. With fast speed, it does
  123. nothing.
  124.  
  125. F6 plays the tape when normal speed is selected. With fast speed, it does
  126. nothing.
  127.  
  128. F7 allows to choose a MDR file (microdrive), protect and unprotect it,
  129. and create a new (and empty) one.
  130.  
  131. F10 resets the spectrum.
  132.  
  133. F11 is volume down.
  134.  
  135. F12 is volume up.
  136.  
  137.  
  138. HOW DO I CHOOSE A FILE WITH THE TAP/TZX OR Z80 SELECTOR?
  139.  
  140. You can choose a file just by moving the white bar with the cursor keys. You
  141. can use also the RePag and AvPag to jump over 12 positions.
  142.  
  143. The files are in white ink, the directories in green ink, and the upper
  144. directory are the two red dots.
  145.  
  146. When you choose a TAP file, it is marked as "save protected", so if you want
  147. to save programs, you must enable it. If you create a new TAP file, it is
  148. marked as "save enabled", so you can start to save directly.
  149.  
  150. The SAVE option works only with the classic ROM routine, so you will be able
  151. to save from programs that use them (it can save programs without header, too,
  152. since the emulator intercepts the call to SA-BYTES). Each new block is added at
  153. the end of the file, but only if the SAVE operation is enabled for this file.
  154.  
  155.  
  156. HOW WORKS THE FAST SPEED LOAD AND SAVE FOR TAP FILES?
  157.  
  158. Just type LOAD "" in the emulator (or choose the TAPE LOADER option in the 128K
  159. menu) and the tape will automagically load. This only works with programs that
  160. uses the ROM to load all the blocks. If you have a TAP file with a program that
  161. uses a custom routine to load the blocks, then you must use the NORMAL SPEED.
  162. To do this, press F3 to go to the TAP menu and choose NORMAL SPEED. Then return
  163. to the emulation (with ESC) and use LOAD "" (or the TAPE LOADER option).
  164. Finally, put the tape in Play with F6. You can stop the tape with F5 and start
  165. it again with F6 as many times you want.
  166.  
  167. When the tape ends, is automatically stoped and rewinded. You can rewind the
  168. tape when you want with the right option in the TAP menu (F3 key).
  169.  
  170. In a near future a block manager will be added, in order to allow the user to
  171. choose a block into the TAP file (thinking in multistage games).
  172.  
  173. Remember that the Fast Speed is available only for TAP files, not in TZX.
  174.  
  175. The FAST SPEED applies when saving too. The SAVE operation is done ALWAYS
  176. when SA-BYTES (in the Spectrum ROM) is called. The difference between FAST and
  177. normal SAVE is that FAST returns inmediately, and NORMAL calls the original
  178. routine. This means that, if you abort the save command, the block will be saved
  179. in the TAP file anyway.
  180.  
  181.  
  182. HOW WORKS THE INTERFACE I AND MICRODRIVE EMULATION?
  183.  
  184. FBZX can emulate an Interface I with one microdrive attached, but only when
  185. working as Spectrum 48K, 128K or +2, never as +2A/+3 since it's incompatible.
  186.  
  187. You just have to choose an MDR file (or create a new MDR file) using the F7
  188. key, and you will be able to use all the Interface I commands and programs.
  189. Remember to format your cartridge (MDR file) after creating one.
  190.  
  191. When you save something to the cartridge, the MDR file is updated as soon as
  192. the Spectrum stops the "motor" of the drive.
  193.